
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>服务端文件上传下载接口 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>服务端文件上传下载接口 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">为了在Java项目中使用七牛云服务，需要引入哪个具体的Maven依赖？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">需要引入的Maven依赖是`com.qiniu`组的`qiniu-java-sdk`，文档中展示的版本是`7.13.0`。</div>
          </div>
          <div class="card-source">来源: 导入SDK</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">在服务间进行文件传输时，文档中定义的数据传输对象(DTO) `ApiFileDto` 包含了哪两个核心字段，它们的作用分别是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">该DTO包含两个核心字段：`private byte[] file;` 用于存储文件的字节数组内容，以及 `private String fileName;` 用于存储文件的原始名称。</div>
          </div>
          <div class="card-source">来源: 定义文件接收DTO</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">为了实现七牛云的文件上传功能，`QiniuConfig` 配置类中创建了哪两个核心的Spring Bean？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">配置类中创建了两个核心Bean：一个是`UploadManager`，用于管理文件上传操作；另一个是`Auth`，用于进行身份认证和生成上传凭证(token)，通过`Auth.create(ak, sk)`方法创建。</div>
          </div>
          <div class="card-source">来源: 七牛云上传信息配置</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">在`FileController`的`apiFileUpload`方法中，上传文件到七牛云的核心步骤是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">核心步骤有两步：第一步是通过`auth.uploadToken(bucket)`获取上传所需的token；第二步是调用`uploadManager.put()`方法，将文件的字节数组、文件名和获取到的token作为参数，执行上传操作。</div>
          </div>
          <div class="card-source">来源: 文件上传接口</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">文档中的`FileController`类提供了几种不同的文件上传接口？它们分别适用于什么场景？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">提供了两种上传接口：一个是`fileUpload`方法，接收`MultipartFile`类型的参数，适用于浏览器直接上传文件的场景；另一个是`apiFileUpload`方法，接收自定义的`ApiFile`对象，适用于服务与服务之间的接口调用上传场景。</div>
          </div>
          <div class="card-source">来源: 文件上传接口</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">文档是如何使用Feign来定义服务间文件操作的客户端接口的？请描述`apiFileUpload`方法的注解使用。</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档通过`@FeignClient`注解声明了一个名为`shop-file`的客户端。其中，`apiFileUpload`方法使用了`@PostMapping("/apiUpload")`来指定请求路径和方法，并使用`@RequestBody`注解来指明`ApiFileDto`参数会作为请求体进行传输。</div>
          </div>
          <div class="card-source">来源: feign接口</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">根据“客户端测试”部分的代码，一个客户端服务调用文件上传接口(apiFileUpload)前需要做哪些准备工作？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">准备工作主要有两步：1. 准备要上传的文件，例如通过`FileInputStream`读取本地文件并使用`IOUtils.toByteArray()`将其转换为字节数组。2. 将文件的字节数组和文件名封装到`ApiFileDto`对象中。</div>
          </div>
          <div class="card-source">来源: 客户端测试</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">在`apiDownload`接口实现中，是如何根据一个URL下载文件并返回其字节内容的？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">首先通过`HttpUtils.doGet(url)`发起HTTP GET请求。然后，从HTTP响应实体中获取输入流`response.getEntity().getContent()`。最后，使用`IOUtils.toByteArray(ips)`将输入流完全读取并转换为`byte[]`数组返回。</div>
          </div>
          <div class="card-source">来源: 文件上传接口</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">在定义的`FilesService` Feign接口中，`apiFileUpload`和`apiDownload`两个方法的返回值分别是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">`apiFileUpload`方法的返回值是`String`类型，代表上传成功后文件的访问URL。`apiDownload`方法的返回值是`byte[]`类型，代表下载到的文件的字节数组。</div>
          </div>
          <div class="card-source">来源: feign接口</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
